CLIを使用してS3のバージョニングを設定し削除したファイルを戻してみる
こんにちは、S3のバージョニングって便利だなと思っているDA部の下地です。
そんなS3のバージョニングをAWS CLIを使用して実装してみましたのでまとめたいと思います。
全体像
aws s3apiとaws s3を使用し以下の手順で実装します(CLIコマンドが使用できるという前提で進めさせてもらいます)。
- バケット作成とバージョニングの設定
- ファイルのアップロードと削除
- objectのバージョンを確認
- ファイルを戻す
1. バケット作成とバージョニングの設定
まずはじめに、2010-test-bucketという名前でS3バケットを作成します。作成時に、--create-bucket-configuration LocationConstraintの指定が必要になるのでap-northeast-1を指定します。
$ aws s3api create-bucket --profile プロファイル名 \
--bucket 2010-test-bucket \
--create-bucket-configuration LocationConstraint=ap-northeast-1
{
"Location": "http://2010-test-bucket.s3.amazonaws.com/"
}
バケットが作成されました。作成したバケットのversioningを有効化するためにs3api put-bucket-versioningを使用します。
$ aws s3api put-bucket-versioning --profile プロファイル名 \ --bucket 2010-test-bucket \ --versioning-configuration Status=Enabled
バケットのバージョニングが有効化されたか確認します。
$ aws s3api get-bucket-versioning --profile プロファイル名 \
--bucket 2010-test-bucket
{
"Status": "Enabled"
}
有効化されていることを確認しました。
2. ファイルのアップロードと削除
次にバージョニングを有効化したS3バケットに、s3 cpを使用してファイルをアップロードします。
$ aws s3 cp test.txt s3://2010-test-bucket/ --profile プロファイル名 upload: ./test.txt to s3://2010-test-bucket/test.txt
s3 lsを使用してバケット内を確認します。
$ aws s3 ls s3://2010-test-bucket/ --profile プロファイル名 2020-10-14 17:22:56 15 test.txt
アップロードしたファイルがあることが確認できました。では、このファイルを削除します。
$ aws s3 rm s3://2010-test-bucket/test.txt --profile プロファイル名 delete: s3://2010-test-bucket/test.txt
バケット内にファイルがないことを確認できました。
$ aws s3 ls s3://2010-test-bucket/ --profile プロファイル名
3. ファイルのバージョンを確認
text.txtはファイルは削除されていますがバージョニングを有効にしているのでファイルのバージョンをs3api list-object-versionsを使用して確認します。
$ aws s3api list-object-versions --profile プロファイル名 \
--bucket 2010-test-bucket \
--prefix test.txt
{
"Versions": [
{
"ETag": "\"ebc92aad19b71192647c7663ecf25f18\"",
"Size": 15,
"StorageClass": "STANDARD",
"Key": "test.txt",
"VersionId": "VoHF9j08Yp.zys8frvWszurCmYjqAD5l",
"IsLatest": false,
"LastModified": "2020-10-14T08:22:56+00:00",
"Owner": {
"DisplayName": "spare-0340",
"ID": "768f6050502b8ce1417048ad447ef58a7357f088ff070255f1041259028d393d"
}
}
],
"DeleteMarkers": [
{
"Owner": {
"DisplayName": "spare-0340",
"ID": "768f6050502b8ce1417048ad447ef58a7357f088ff070255f1041259028d393d"
},
"Key": "test.txt",
"VersionId": "N3a0VLfBZRMXDAand3KSErfLFwFuOcOF",
"IsLatest": true,
"LastModified": "2020-10-14T08:26:17+00:00"
}
]
}
VersionsとDeleteMarkerの2つがあります。
4. ファイルを戻す
先ほど確認したDeleteMarkerを削除するとファイルが削除される前の状態に戻りますので、DeleteMarkerのVersionIdを指定し削除します。削除する際にはs3api delete-objectを使用します。
aws s3api delete-object --profile プロファイル名 \
--bucket 2010-test-bucket \
--key 2010_versioning/test.txt \
--version-id N3a0VLfBZRMXDAand3KSErfLFwFuOcOF
{
"DeleteMarker": true,
"VersionId": "N3a0VLfBZRMXDAand3KSErfLFwFuOcOF"
}
ではdeleteマーカーを削除しましたので、ファイルがあるか確認します。
aws s3 ls s3://2010-test-bucket/ --profile プロファイル名 2020-10-14 17:22:56 15 test.txt
削除したファイルが戻ったことが確認できました！
まとめ
S3のバージョニングはとても便利だなと実感したのでCLIを使用して実装しました。この記事がどなたかの助けになれば幸いです。
![[S3] フォルダ内のオブジェクトをすべて削除したらフォルダごと削除された](https://images.ctfassets.net/ct0aopd36mqt/wp-thumbnail-066beb776f0c57ce64255fadcc072f60/82b2f6687ab5774cd73f9176dcac7855/amazon-s3)
